Skip to content

Improve help and doc #22 - #23

Merged
pombredanne merged 4 commits into
mainfrom
improve-help-and-doc
Jan 16, 2023
Merged

Improve help and doc #22#23
pombredanne merged 4 commits into
mainfrom
improve-help-and-doc

Conversation

@pombredanne

Copy link
Copy Markdown
Member

This PR improves the intro documentation in the readme and the generated website help page.

Reference: #22

* Add overview section in README and in doc
* Use rst for README
* Remove copyright years from notices
* Use venv subdirectory for virtualenv

Signed-off-by: Philippe Ombredanne <pombredanne@nexb.com>
Signed-off-by: Philippe Ombredanne <pombredanne@nexb.com>
Comment thread README.rst
@@ -0,0 +1,126 @@
ScanCode LicenseDB

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mjherzog @DennisClark FYI... this parts would need your review and I could then propagate the edits to the help page too

* add new CLA license category
* update license category docs
* update reference to .LICENSE files correctly

Signed-off-by: Ayan Sinha Mahapatra <ayansmahapatra@gmail.com>

@AyanSinhaMahapatra AyanSinhaMahapatra left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've pushed a commit with some minor changes:

  • update reference to .LICENSE files correctly
  • update README with the same and misc
  • add new CLA license category
  • update license category docs

@DennisClark DennisClark left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

approved for Earth and beyond!

@pombredanne
pombredanne merged commit 88c9010 into main Jan 16, 2023
@pombredanne
pombredanne deleted the improve-help-and-doc branch January 16, 2023 11:56
@pombredanne

Copy link
Copy Markdown
Member Author

@AyanSinhaMahapatra ^ not sure how this meshes with your work in progress in ScanCode toolkit

@AyanSinhaMahapatra

Copy link
Copy Markdown
Member

@pombredanne I've had pushed a commit here and also updated this in #26 so it is all updated AFAIK

AyanSinhaMahapatra added a commit to aboutcode-org/scancode-toolkit that referenced this pull request Jan 17, 2023
Reference: aboutcode-org/scancode-licensedb#23
Signed-off-by: Ayan Sinha Mahapatra <ayansmahapatra@gmail.com>
@AyanSinhaMahapatra

Copy link
Copy Markdown
Member

No we missed the help.html which got replaced as we now build from scancode-toolkit. Opened a PR to fix this.

pombredanne added a commit to aboutcode-org/scancode-toolkit that referenced this pull request Jan 18, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants